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PREFACE 


This document describes the source file components which make up the 
version 3 PDP-15 Disk Operating System, DOS-15 V3A, and explains the 
steps which must be taken to assemble a binary from the source and 
to incorporate it into an existing DOS-15 V3A system. 

To follow the steps outlined in this document the reader should be 
familiar with the following utility programs: 


Program 

As Described in Manual 

DOSSAV 

DOS User's Manual, DEC-15-0DUMjf\-B-D 

MACRO- 15 

MACRO 15 Assembler Programmer's Reference 
Manual, DEC-15-LMACA-B-D 

MACRO- 11 

MACll Assembler Programmer's Reference 
Manual, DEC-15-LMCMA-A-D 

PATCH 

PATCH Utility Program, DEC- 15-UP ATA-A-D 

PIP 

PIP DOS Monitor Utility Program, 
DEC-15-UPIPA-A-D 

SGEN 

SGEN-DOS Utility Program, DEC-15-USGNA-A- 

UPDATE 

UPDATE Utility Program, DEC-15-YWZB-DN7 


iv 



INTRODUCTION 


Source files for DOS-15 V3A are available on DECtapes or 7 or 9 
track magtape. The steps required for each source are listed either 
in Table 1, Table 2 , or Table 3. 

The first step of assembling, in some cases, is to rename the file 
prior to assembly. This is not a necessity but in this document it 
simplifies the explanation of command strings required to install 
the assembled binaries. However, the user can perform the renaming 
process after assembly or, when making binary input to the PATCH 
utility program, forego renaming altogether. 

The second step is to assemble the source using the proper assembler. 
Most of the sources are assembled using the MACRO-15 assembler (Table 1) 
A few are assembled using MACRO- 11 (Table 2) . Some are to remain as 
source files and others are to be compiled by FORTRAN (Table 3) . 

There are two programs which cannot be assembled by the user under 
DOS-15: they are the sources which make up the PDP-11 code for the 

MACRO-11 assembler and the source for the ABSLll paper tape loader. 

This is explained in the notes. 

Some source files are conditionally coded to produce several different 
binaries based either on the existence or nonexistence of definitions 
for given symbols or on their defined values. 

The type of binary produced by the assemblers will vary. For 
MACRO-15 output in Table 1 there is a column which shows either BIN 
(relocatable binary) , ABS (absolute binary) or HRM (hardware readin 
mode) . BIN and ABS files can be produced on a directoried device 
such as disk. HRM files must be assembled directly onto paper tape. 

It is standard practice with MACRO-15 BIN files to shorten them 
by using the UPDATE utility program with the S option. 

In Table 2, output from the MACll assembler is listed as OBJ which 
means OBJECT MODULE. Object modules are converted to load modules 
by a linker. Load modules and object modules are provided as 
absolute binary code on paper tape. 
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Table 1 


Sources Assembled Under MACRO- 15 


Source File 

Name 

Rename 

To 

It 

_ Desired 
Version 

Assembly 

Parameters 

Type of 
Binary 

Footnote 

ABSLll 

014 

- 


- 

- 

HRM 

10 

CD. DOS 

031 

CDB. 

ja'si 

CR<^3B*/023** 

- 

BIN 

1 



CDB. 

^31 

CI^3B/j2^26 

DEC026=0 

BIN 

1 



CDB. 

^31 

CRl 5/^29 

CR15=/ 

BIN 

1 



CDB. 

CDB. 

J^31 

p31 

CRl5/jZ(26 

CI^1E/CR^2B 

^29 

CRl5=j/ 

DECj2f26=je^ 

NOTGDI=(Zf 

BIN 

BIN 

1 

1 



CDB. 

031 

CR01E/CR^2B 

^26 

NOTGDI=0' 

DECp^26=j0 

BIN 

1 



CDB. 

031 

CRll/j/29 

Spooled*** 

UC15=J2f 

BIN 

1 



CDB. 

031 

CR11//26 

Spooled*** 

UC15=i2j' 

DEC^26=J^ 

BIN 

1 



CDB. 

0l31 

CRll/p'29 

Unspooled*** 

UC15=/ 

NOSPL=j^ 

BIN 

1 



CDB. 

031 

CRll/j2f26 

Unspooled*** 

\JC15^0 

DECi^26=jef 

N0SPL=;3 

BIN 

1 

CHAIN 

154 

- 


- 

- 

ABS 

2 

CREF 


- 


- 

- 

ABS 

2 

DDT 

012 

- 


PAGE MODE 

- 

BIN 

4 

DOSBCD 

005 

BCDB. 

005 

BANK MODE 

All Versions 

CR03B*/029** 

PDP9=^a^ 

BCDSTA=xxxxx 

BCDADR=yyyyy 

BIN 

ABS 

4 

12 

6,12 



BCDB. 

p(f35 

CR03B/^26 

DEC026=0 

ABS 

6,12 



BCDB. 

0J3 5 

CR01E/CR02B 

J029 

NOTGDI=0 

ABS 

6,12 



BCDB. 

05 

CRO1E/CP02B 

jar26 

NOTGDI=0 

DEC026=0 

ABS 

6,12 

DTA. 

023 

- 


- 

- 

BIN 

1 

DOSNRM 

074 

DOS 15 

014 

NO UC15 

- 

BIN 

5 





HAVE UC15 

UC15=0 

BIN 

5 


*Type of controller. 

**Type of card code. 

***Spooled and unspooled refer to how the device is handled when the UNICHANNEL-15 
spooler is turned on. 
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Table 1 (Cont.) 

Sources Assembled Under MACRO-15 


Source File 

Name 

Rename 

To 

It 

Desired 

Version 

Assembly 

Parameters 

Type of 
Binary 

DOSPIP 

103 

PIP 

103 

- 


BIN 

DOSRFA 

140 

DKA. 

140 

DKA. 

- 

BIN 



DKB. 

140 

DKB. 

%BVERS=0' 

BIN 



DKC. 

140 

DKC. 

%CVERS=0 

BIN 



DKL. 

140 

DKL. 

%LVERS=0 

ABS 



RKA. 

140 

RKA. 

%RKj^5=0' 

%RP02=^ 

BIN 



RKB. 

140 

RKB, 

%RK05=0' 

%RP02=0 

%BVERS=0 

BIN 



RKC. 

140 

RKC. 

%R]gZ^5=0 

%RP02=0 

%CVERS=;e^ 

BIN 



RKL. 

140 

RKL. 

%RK05=0 

%RP02=0 

%LVERS=0 

MS 



DPA. 

140 

DPA. 

%RP02=0 

BIN 



DPB. 

140 

DPB. 

%RP0'2=0 

%BVERS=0 

BIN 



DPC. 

140 

DPC. 

%RP,0'2=0' 

%CVERS=^ 

BIN 



DPL. 

140 

DPL. 

%RP02=i3^ 

%LVERS=0' 

MS 

DOSSAV 

065 

- 


- 

- 

HRM 

DTC. 

0ji3 

- 


- 

- 

BIN 

DTCOPY 

010 

- 


- 

- 

BIN 

DTD. 

006 

- 


- 

- 

BIN 

DTE. 

/506 

- 



- 

BIN 

DTF. 

01 

- 


- 

- 

BIN 

DUMP 

014 

- 


No CLOSE on 

- 

MS 

DYLDR 

00)2^ 

- 


1 every oper , 
[CLOSE on 

UC15=0 

BIN 

EDIT15 

022 

EDIT 

022 

every oper . 
EDIT 

- 

BIN 



EDITVP 

022 

EDITVP 

EDITVP=0 

BIN 



EDITVT 

022 

EDITVT 

i 

EDITVT=0' 

BIN 


Footnote 
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Table 1 (Cont.) 


Sources Assembled Under MACRO-15 


Source 

Name 

File 


Rename 

To 

It 

Desired 

Vers ion 

Assembly 

Parameters 

Type of 
Binary 

Footnote 

EXECUT 


050 

- 


PAGE MODE 

- 

BIN 

4 






BANK MODE 

PDP9=0' 

PDP15=jZf 

BIN 

4 

FNEW 


004 

- 


- 

- 

BIN 

4 

FOCAL 


025 

- 


PAGE MODE 

- 

BIN 

4 






BANK MODE 

%PDP9=J^^ 

%PDP15=0 

BIN 

4 

FORT 


p2 

- 


- 

- 

BIN 

3 

FORTRAN 

OTS 


- 


- 

- 

- 

8 

F4P1 


049 

SEE F4P2 

- 

- 

- 

- 

F4P2 


049 

F4 

049 

F4X 

- 

BIN 

in 

00 




F4 

049 

FPF4X 

%FPP=J2J 

BIN 

8,5 




F4 

049 

F4X9 

%PDP9=0 

BIN 

8,5,13 

INSTRC 


m 

- 


- 

- 

BIN 

4 

LKA. 



- 


- 

- 

BIN 

1 

.LOAD 


028 

- 


PAGE MODE 

- 

BIN 

4 




- 


BANK MODE 

PDP9=0 

BIN 

4 

LPA.09 


>2(04 

LPA. 

JZJ04 

- 

- 

BIN 

1,13 

LPA.15 


049 

LPA. 

049 

FORM FEED ON 

.CLOSE 

- 

BIN 

1 




LPA. 

049 

NO FORM FEED 

ON .CLOSE 

NOFF=l 

BIN 

1 

LPU. 



LPA. 

p 26 

FORM FEED ON 
.INIT, .CLOSE, 
COUNT OF 58 

LINES 


BIN 

1 




LPA. 

P2^ 

OTHER LINE 

COUNT 

FFCNT=OCTAL 

COUNT 

BIN 

1 




LPA. 

02p 

AND HANDLER - 
GENERATED FROM 

FEED 

NOFF^ 

BIN 

1 




LPA. 

J621S 

UNSPOOLED* 

OPERATION 

NOSPL=0 

BIN 

1 


*If the UNICHANNEL-15 spooler is turned on, this version of the line printer 
handler will run unspooled. 
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Table 1 (Cont.) 


Sources Assembled Under MACRO-IS 


Source File 

Name 

Rename 

To 

It 

Desired 

Version 

Assembly 

Parameters 

Type of 
Binary 

Footnote 

LP.647 

00. 

LPA. 

002 

TAB STOP=8 

- 

BIN 

1,13 



LPA. 

002 

TAB STOP=l/l 

TAB10=0 

BIN 

1 

LTORPB 


- 


- 

- 

BIN 

3 

LTX. 

000 

- 


- 

- 

BIN 

16 

MACIMG 

006 

“ 


FOR 8K PDP-11 

— 

BIN 

9 





FOR 4K PDP-11 

LM4K=0' 

BIN 

9 





FOR 12K PDP-11 

LM12K=;ef 

BIN 

9 

MACINT 

014 

MACll 

014 

FOR 8K PDP-11 

- 

ABS 

9 





FOR 4K PDP-11 

LM4K=0 

ABS 

9 





FOR 12K PDP-11 

LM12K=»0 

ABS 

9 

MACR15 

086 

MACRO 

086 

- 

- 

ABS 

2 

MTA. 

004 

- 


- 


BIN 

1 

MTC. 


- 


- 


BIN 

1 

MTDUMP 

005 

- 


- 

- 

BIN 

5 

MTF. 

012 

- 


- 


BIN 

1 

NUVAL 

0JdJQ 

- 


- 

- 

BIN 

3 

PATCH 

018 

- 


- 

- 

ABS 

2 

PPA. 

001 

- 


- 

- 

BIN 

1 

PPB. 

/eieri 

- 


- 

- 

BIN 

1 

PPC. 

001 

- 


- 

- 

BIN 

1 

PRA. 

000 

- 



- 

BIN 

1 

PRB. 

000 

- 



- 

BIN 

1 

QFILE 

010 

- 


- 

- 

BIN 

5 
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Tcible 1 (Cont.) 


Sources Assembled Under MACRO-15 


Source File 

Rename It 

Desired 

Assembly 

Type of 

Footnote 

Name 

To 

Version 

Parameters 

Binary 


RESMON 084 


No UC15 


ABS 

2,6,12 ,15 



UC15 

UC15=0 

ABS 

2,6,12,15 



UC15 

No LP TCB 

UC15=0 

LPTCB=0 

ABS 

2,6,12,15 



UC15 

No CD TCB 

UC15=0 

CDTCB=0 

ABS 

2,6,12, 15 



UC15 

No XY TCB 

UC15=0 

XYTCB=0 

.ABS 

2,6,12, 15 



UC15 

No spare TCB's 
(Call delete) 

UC15=0 

TCB=0 

■ABS 

2,6,12, 15 



UC15 

No Spare #1 TCB 

UC15=0 

TCB 1=0 

MS 

2,6,12, 15 



UC15 

No Spare #2 TCB 

UC15=0 

TCB 2=0 

MS 

2,6,12,15 



UC15 

No Spare #3 TCB 

UC15=0 

TCB3=0 

MS 

2,6,12,15 

RFBOOT 014 

- 

- 

- 

HRM 

- 


- 

UC15 Option 

UC15=0 

HRM 

- 

RKBOOT 014 

- 

- 

- 

HRM 

- 

RPBOOT 006 

- 

- 

- 

HRM 

- 


- 

UC15 Option 

UC15=0 

HRM 

- 
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Table 1 (Cont.) 


Sources Assembled Under I4ACRO-15 


Source File 

Name 

Rename 

To 

It 

Desired 

Version 



Assembly 

Parameters 

Type of 
Binary 

Footnote 

SGEN 

045 

- 


- 

- 

BIN 

5 

SGI®LK 

020 

- 


RF SYSTEM 

> 

ABS 

6 



- 


RK SYSTEM 

RK^5=0' 

ABS 

6 



- 


RP SYSTEM 

RP/2=JZf 

ABS 

6 

S PL IMG 

002 

- 


- 

SPOLSZ=SIZE OF 

SPOLll PROGRAM 

BIN 

9 

SP0L15 

023 

SPOOL 

023 


FB=FIRST BLOCK 

NUMBER OF SPOOL 

PROGRAM 

SPOLSZ=SIZE OF 

SPOLll PROGRAM 

ABS 

9 

SRCCOM 

011 

- 


- 

- 

BIN 

5 

SYSBLK 

013 

- 


RF SYSTEM 

- 

ABS 

2 



- 


RK SYSTEM 

RK0'5=0 

ABS 

2 



- 


RP SYSTEM 

RP02=0 

ABS 

2 

.SYSLD 

;353 

- 


- 

- 

ABS 

2,6 

TRACK 

003 

- 


- 

- 

BIN 

3 

UPDATE 

005 

- 


- 

- 

ABS 

o 

VPA. 

013 

- 


VPA. 

- 

BIN 

1 



- 


VPA.S 

VPA.S=0' 

BIN 

1 

VTA. 


- 


- 

- 

BIN 

1 

VTPRIM 

j0'0'4 

- 


- 

- 

BIN 

3 

VWA. 

003 

- 


- 

- 

BIN 

1 

XYU. 

032 

XYA. 

032 

XYll PLOTTER 

- 

BIN 

1 



XYA. 

032 

XYll PLOTTER, 
UNSPOOLED 

OPERATION 

NOSPL=0 

BIN 

1 

8TRAN 

001 

- 


- 

- 

BIN 

5 

89TRAN 

001 

- 


- 

- 

BIN 

5 
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Table 2 


Sources Assembled Under MACRO-ll 


Source File 
Name 


LM4K MAC 
LM8K MAC 
LM12K MAC 
MACROl MAC 
MACR02 MAC 
MACROS MAC 
MACROS MAC 
MCIOCH MAC 
MEMSIZ MAC 
PIREX 


Rename It Desired 
To Version 


Assembly 

Parameters 


PST MAC 

SPOLll *23 


No Devices 

1 ” 

With CRll 

$CD= 20000 

With DECtape 

$DT=0 

With LPll/LSll/ 
LVll 

$LP=040000 

With LVll 

$LV=0 

With XYll Off- 
line switch 

$PL=10000 

With XYll No 

Off-line Switcl: 

$PL=10000 

$NOSW=0 

With RK05 j 

$RK= 100000 

With XY311 1 

inches scale 

$PL=010000 

$PL311=0 

With XY3il ^ 

metric scale 

$PL=010000 

$PL311=0 

$UNIT=0 

With CRll 

$CD=020000 

With LPll/LSll 

$LP=040000 

With y.YJ 1 

$PL=010000 


Type of 
Binary 

Footnote 

OBJ 

9 

OBJ 

9 

OBJ 

9 

OBJ 

9 

OBJ 

9 

OBJ 

9 

OBJ 

9 

OBJ 

9 

OBJ 

9 

OBJ 

11 

OBJ 

11 

OBJ 

11,14 

OBJ 

11,14 

OBJ 

11,14 

OBJ 

11,14 

OBJ 

11,14 

OBJ 

11 

OBJ 

11,14 

OBJ 

1 

11,14 

OBJ 

9 

OBJ 

9 

OBJ 

9 

OBJ 

9 


*See footnote 9. The * in the file name extension represents several possible characters, 
as explained in the footnote. 
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Table 3 


Miscellaneous Sources 


Source File 

Name 

Desired 

Version 

Special 

Instructions 

Type of 

Binary 

Footnote 

CIRCLE 

SRC 

- 

COMPILE WITH 

FORTRAN 

BIN 

3 

I NS ALL 

0^4 

NO UC15 

RENAME IT TO 

INSALL SRC 

N/A 

4 

INSALL 

U05 

HAVE UC15 

RENAME IT TO 

INSALL SRC 

N/A 

4 

INSERR 

jSj^2 

- 

RENAME IT TO 

INSERR SRC 

N/A 

4 

ROTATE 

SRC 

- 

COMPILE WITH 

FORTRAN 

BIN 

3 

^TECTOR 

SRC 

- 

COMPILE WITH 

FORTRAN 

BIN 

3 
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The type of binary produced affects the method by which it is incor- 
porated into an existing system. The last column in each table 
references an explanatory note which describes the method of binary 
installation. 

EXPLANATORY NOTES 

First, the disk system must be restored to the disk using DOSSAV. 
Then, after assembling the code, one of the following steps must 
be performed as indicated in the footnotes to Tables 1, 2, and 3. 

1. Nearly all relocatable binary I/O handlers should be transferred, 
using PIP, to the <IOS> directory, e.g., 

>Tt_, DKuj< lOS >-s-DKu-i<SCR>i_jCDB .uJ BIN^ 

2. With the exception of a few PDP-11 programs, all programs which 
are to be core image (SYS) files are installed by using the 
PATCH program. The following example is for assembled binaries 
whose file extension is ABS: 

PATCH Vnn 
>CHAIN,) 

>READujCHAIN^ 

> 

3. Some relocatable binary routines are kept in the <PER> directory. 
They can be transferred there using PIP, e.g., 

>Tu-i DK i_i<PE R> ^DK i»j< SCR>i-j C IRCLEi_iB IN ^ 

4. The BANK and PAGE mode versions of these programs should be 
transferred, respectively, to the <BNK> and <PAG> directories 
using PIP with commands similar to those above. Although FNEW 
is not conditionalized, it goes hand in hand with FOCAL. Thus, 
a copy of FNEW BIN should be transferred to both directories. 
INSTRC BIN, INSERR SRC, and INSALL SRC should be transferred to 
both the <BNK> and <PAG> directories using PIP, INSTRC BIN 

is the program which implements the Monitor's $INSTRUCT command 
and INSERR SRC and INSALL SRC are its data files. 
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5. With the exception of a few PDP-11 programs, all programs which 
are to be core image (SYS) files are installed by using the 
PATCH program. The following example is for assembled binaries 
whose file extension is BIN: 


PATCH Vnn 
>D0S15V 

>READRi_jl6077i^DOS15^ 


For the programs in this category, the following numeric argu- 
ments are needed in the READR command: 


PIP 

17600 

D0S15 

16077 

EDIT 

17143 

EDITVP 

17075 

EDITVT 

17122 

MTDUMP 

17600 

QFILE 

17477 

SGEN 

16122 

8TRAN 

17600 

89TRAN 

17600 

DTCOPY 

17600 

F4 

17600 

SRCCOM 

17600 


6. A few programs with ABS file extensions are installed using 
PATCH into programs with dissimilar names. For example. 


PATCH Vnn 

>RESMON^ 

>READi_jSGNBLKy 


The file SGNBLK is patched into RESMON. Files in this category 
are : 


File 

is Patch 

DKL. 

.SYSLD ) 

RKL. 

.SYSLD > 

DPL. 

.SYSLD ) 

SGNBLK 

RESMON 

BCDB. 

RESMON 


Choose one of the threse as a function 
of which disk is the system device 
(DKL. is for the RF15/RS)?9 Disk) . 


7. There is no conditional assembly required for MACRO-15, It 
determines whether or not to run as the page mode version 
(MACRO-15) or the bank mode version (BMACRO-15) by ci dynamic 
test at run time. 
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8. Assembly instructions for the FORTRAN OTS routines are given in 
an appendix to the manual PDP-15 FORTRAN IV OPERATING ENVIRONMENT, 
DEC-15-LFEMA-A-D . 

Assembly of the compiler, because it is in two parts, requires 
a special command string to MACRO-15, e.g., 

>FZ-^F4P1i_j044,F4i«i044^ 

with additional command characters as necessary. After 
assembling the compiler, see note 5. 

9. SPOOL and MACll are PDP-11 programs that exist as PDP-15 system 
programs. Each of these system programs contains some PDP-15 
code at the beginning; this code is the system interface. Both 
these system programs are laid out on the disk as indicated 
below; 


Contiguous 
area of disk 
allocated to 
system program 
by SGEN 






) 


PDP-15 code increasing disk 

block #*s 


Space for expansion bug fix 


PDP-11 code 


Space for expansion bug fix 


In order to build the image of both these programs, space on 
the system disk has to be reserved through SGEN, using the 
following information. 


MACll* no overlays ^ 2 buffers 

40 blocks (octal) 

-12 and -11 .DAT slots 

*See Appendix on UC15 Options in Unichannel-15 Software Manual 
(DEC-15-XUCMA-A-D) for further details. 
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SPOOL 


no overlays or buffers 
45 blocks (octal) 


After creating the system programs via SGEN the images can 
be built as follows: 


MACll: 


a. Assemble MACIMG 006 using MACRO-15 to 
produce MACIMG BIN, 


b. 


Assemble the different pieces of MACll, 
as indicated below, using MACRO-11 under 
DOS-11 (a step which cannot be done by 
the PDP-15 customer) , 


# MCUCX ,j^ : /CR^ <LM8K , MEMS I Z , MACRO 1 , 

r MCI0CH,MACR02^ 

if a CREF listing is required, 
othe:^ise null string 

# MCUCA : /CR^<LM8K , MEMS IZ , MACRO 1 , 

MCIOCH, MACROS, MACROS^ 


The above 2 assemblers will produce the 
object modules MCUCX. OBJ and MCUCA, OBJ 
for an 8K UC15 system. For 4K and 12K 
UC15 systems use LM4K and LM12K respectively 
instead of LM8K. 

#MCUPST,LP:/CRF<LM8K,PST<i) 


c. To produce the load module of MACll on 
papertape the above 3 object modules 
have to be linked by the DOS-11 linker 
(not available to PDP-15 customers), i.e.. 


#PP :MCUC15/SQ,|l^ <MCUCX, MCUCA, MCUPST/B : 0/E 
for a load map 


d. GLOAD on DOS-15 (load and execute) MACIMG 
BIN after loading the MACll object module 
on the high speed paper tape reader and is- 
suing API OFF, A 'DONE' message is printed 
on the console when the image of MACll has 
been successfuly built on the disk in the 
area reserved by SGEN, MACIMG performs its 
own I/O; hence, it does not require assign- 
ments to .DAT slots. 


e. Rename MACINT 014 to MACll 014, assemble 
with MACRO- 15 and then use PATCH as shown 
in note 2, to install it into MACll. 
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SPOOL : 


a. Assemble SPOLll *28 under MACll to produce 
the SPOLll load module on paper tape. The * 
in the file name extension can be any of the 
following, which indicate which assembly 
parameters are defined internally in the 
source code. To change assembly parameters 
one must edit the source file. 

* = 1 for null task 

= A for LPll/LSll task only 
= B for CRll task only 
= C for LPll/LSll and CRll tasks only 
= D for XYll task only 
= E for LPll/LSll and XYll tasks only 
= F for XYll and CRll tasks only 
= G for LPll/LSll, XYll and CRll 
tasks only 

For example, 

SPOLll C22 should be the name of the source 
file when the spooled devices are to be 
LPll/LSll and the CRll. 

b. Assemble SPLIMG 002 under MACRO-15. 

c. Issue an API OFF command to DOS then, 

GLOAD SPLIMG BIN after loading the SPOLll 
object module in the high speed paper tape 
reader. A "DONE" message is printed on the 
console when the image of SPOL 11 has been 
successfully built on the disk. 

d. Rename SP0L15 023 to SPOOL j2f23, assemble 
with MACRO- 15 and then use PATCH, as shown 
in note 2, to install it into SPOOL. 


10. The ABSLll loader cannot be assembled with the version of MACRO-15 
supplied to customers. It requires a special version of MACRO-15, 
called MACRO-D, used to generate PDP-15 Diagnostic programs. The 
difference is in the load addresses for HRM tapes: 17720 for 
MACRO-15 and 17700 for MACRO-D. 


11. PIREX is conditionalized so that code for only existing devices 
need be assembled. The output from MACll to paper tape is an 
absolute binary object module which is loaded into the PDP-11 
by the ABSLll loader as described in the Unichannel-15 Software 
Manual, (DEC-15-XUCMA-A-D) . The conditionalization for DECtape 
and LVll is listed for the user's convenience. These devices 
are not software supported by DEC. 


12. DOSBCD, the batch card reader handler, is part of the resident 

monitor. The position in core memory occupied by DOSBCD depends 
upon the size of the resident monitor (RESMON) . Thus the 
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start address of DOSBCD, BCDSTA^ is a variable which can be defined 
as an assembly parameter. Also, certain addresses in DOSBCD must 
be supplied to RESMON at a specific address, BCDADP, to insure 
proper operation. Both parameters are defined from values obtained 
from an assembly listing of RESMON. The value to be assigned to 
BCDSTA should be the same as the value of the parameter CD, defined 
by the line CD=. , in RESMON. The value for BCDADR should be set 
equal to the location one higher than the address tap DATLl in 
RESMON. 


For RESMON 004 these values are: 



NO UC15 

HAVE UC15 

BCDSTA 

6463 

7572 

BCDADR 

11726 

13041 


13. The steps taken to produce the DOS-15 tapes distributed by DEC 
vary from those outlined in the tables in a few cases: 


a. The F4X9 version of the FORTRAN compiler was made by 
renaming the source file F4P2 j2f49 to F4X9 049 , rather 
than to F4 J2f49 as shown in Table 1. The resulting 
binary file after assembly is F4X9 BIN rather than 
F4 BIN. This was done so that this particular version 
of the compiler could readily be identified in the 
disk’s <PER> UFD. The code produced either way is 
identical . 


b. The LP09 line printer handler was not renamed to LPA. 

004, as indicated in Table 1, so that the binary file 
in the disk's <PER> UFD can be identified as LPA. 09 
BIN. 


c. The 647 line printer handler was not renamed to LPA. 

002, as indicated in Table 1, so that the binary file 
in the disk's <PER> UFD can be identified as LP.647 BIN. 
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14. OFFLINE SWITCH 


The CALCOMP plotter does not have an offline switch. This 
leads to difficulty in stopping the plotter to refill pen, 
take off plots, etc. Bit 2 switch of the PDP-11 console 
switches is to be used as the offline switch for the CALCOMP, 

If you do NOT wish this feature define $NOSW=0, 

Note, for $PL311, this is automatically disabled, do not 
define 1 1 

Conditional Assembly for XYll or XY311 Plotter Interface 
$PL311 if defined will generate the control bytes required 
for CALCOMP 's 936. If undefined, the control bytes for 
CALCOMP 's 500 series are generated. If $PL311 is defined 
then the units for the plotter step size should be speci- 
fied. $UNITS defined generates a metric plotter. Unde- 
fined gives one in inches. 

15. The UC15 version of the RESMON contains six special buf- 
fers utilized as PIREX/DOS TCB's, These buffers are 
utilized as follows: 

1. A 117 word Line Printer TCB, 

2. A 65 word Card Reader TCB. 

3. A 117 word Plotter TCB. 

4. A 24 word Spare TCB. 

5. A 120 word Spare TCB, 

6. A 170 word Spare TCB, 

The spare TCB's are available for the use of customer 
programs desiring communication with PIREX, 

If any of these TCB's are not needed - they can be deleted 
by utilizing the appropriate assembly parameter, 

16. LTX. is a dummy handler. See the SGEN-DOS UTILITY PROGRAM MANUAL. 
(DEC-15-USGNA-A-D) for more details about the use of LTX. 
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HOW TO OBTAIN SOFTWARE INFORMATION 


SOFTWARE NEWSLETTERS, MAILING LIST 

The Software Communications Group, located at corporate headquarters in 
Maynard, publishes newsletters and Software Performance Summaries (SPS) 
for the various Digital products. Newsletters are published monthly, 
and contain announcements of new and revised software, programming 
notes, software problems and solutions, and documentation corrections. 
Software Performance Summaries are a collection of existing problems 
and solutions for a given software system, and are published periodi- 
cally. For information on the distribution of these documents and how 
to get on the software newsletter mailing list, write to: 

Software Communications 
P. 0. Box F 

Maynard, Massachusetts 01754 


SOFTWARE PROBLEMS 


Questions or problems relating to Digital's software should be reported 
to a Software Support Specialist. A specialist is located in each 
Digital Sales Office in the United States. In Europe, software problem 
reporting centers are in the following cities. 


Reading, England 
Paris, France 
The Hague, Holland 
Tel Aviv, Israel 


Milan, Italy 
Solna, Sweden 
Geneva, Switzerland 
Munich, West Germany 


Software Problem Report (SPR) forms are available from the specialists 
or from the Software Distribution Centers cited below. 


PROGRAMS AND MANUALS 


Software and manuals should be ordered by title and order number. In 
the United States, send orders to the nearest distribution center. 


Digital Equipment Corporation 
Software Distribution Center 
146 Main Street 
Maynard, Massachusetts 01754 


Digital Equipment Corporation 
Software Distribution Center 
1400 Terra Bella 

Mountain View, California 94043 


Outside of the United States, orders should be directed to the nearest 
Digital Field Sales Office or representative. 


USERS SOCIETY 


DECUS , Digital Equipment Computer Users Society, maintains a user ex- 
change center for user-written programs and technical application in- 
formation. A catalog of existing programs is available. The society 
publishes a periodical, DECUSCOPE, and holds technical seminars in the 
United States, Canada, Europe, and Australia. For information on the 
society and membership application forms, write to: 


DECUS 

Digital Equipment Corporation 

146 Main Street 

Maynard, Massachusetts 01754 


DECUS 

Digital Equipment, S.A. 
81 Route de I'Aire 
1211 Geneva 26 
Switzerland 



READER'S COMMENTS 


DOS-15 ASSEMBLY PARAMETERS 
DEC - 1 5 -ODAP A- A-D 


NOTE: This form is for document comjnents only. Problems 

with software should be reported on a Software 
Problem Report (SPR) form (see the HOW TO OBTAIN 
SOFTWARE INFORMATION page) . 


Did you find errors in this manual? If so, specify by page. 


Did you find this manual understandable, usable, and well-organized? 
Please make suggestions for improvement. 


Is there sufficient documentation on associated system programs 
required for use of the software described in this manual? If not, 
what material is missing and where should it be placed? 


Please indicate the type of user/reader that you most nearly represent. 

f~] Assembly language programmer 

□ Higher-level language programmer 

□ Occasional programmer (experienced) 

I I User with little programming experience 
I I Student programmer 

I I Non-programmer interested in computer concepts and capabilities 

Name Date 

Organization 

Street 

City State Zip Code 

or 

" Country 

If you do not require a written reply, please check here. □ 
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